<HTML>
<BODY BGCOLOR="white">
<PRE>
<FONT color="green">001</FONT>    package org.hackystat.telemetry.analyzer.reducer;<a name="line.1"></a>
<FONT color="green">002</FONT>    <a name="line.2"></a>
<FONT color="green">003</FONT>    import org.hackystat.telemetry.analyzer.model.TelemetryStreamCollection;<a name="line.3"></a>
<FONT color="green">004</FONT>    import org.hackystat.dailyprojectdata.client.DailyProjectDataClient;<a name="line.4"></a>
<FONT color="green">005</FONT>    import org.hackystat.sensorbase.resource.projects.jaxb.Project;<a name="line.5"></a>
<FONT color="green">006</FONT>    import org.hackystat.utilities.time.interval.Interval;<a name="line.6"></a>
<FONT color="green">007</FONT>    <a name="line.7"></a>
<FONT color="green">008</FONT>    /**<a name="line.8"></a>
<FONT color="green">009</FONT>     * Provides the Telemetry reducer interface. A reducer is responsible for processing raw software<a name="line.9"></a>
<FONT color="green">010</FONT>     * metrics to generate an instance of &lt;code&gt;TelemetryStreamCollection&lt;/code&gt;. <a name="line.10"></a>
<FONT color="green">011</FONT>     * &lt;p&gt;<a name="line.11"></a>
<FONT color="green">012</FONT>     * Note to reducer implementers: <a name="line.12"></a>
<FONT color="green">013</FONT>     * &lt;ul&gt;<a name="line.13"></a>
<FONT color="green">014</FONT>     *   &lt;li&gt; The "time periods" for the data points in the generated telemetry stream(s) <a name="line.14"></a>
<FONT color="green">015</FONT>     *        must be derived from the 'interval' parameter.  <a name="line.15"></a>
<FONT color="green">016</FONT>     *   &lt;li&gt; Reducer implementation class must have a public constructor which takes no parameters.<a name="line.16"></a>
<FONT color="green">017</FONT>     *   &lt;li&gt; Reducer implementation must be thread-safe.<a name="line.17"></a>
<FONT color="green">018</FONT>     * &lt;/ul&gt;<a name="line.18"></a>
<FONT color="green">019</FONT>     * <a name="line.19"></a>
<FONT color="green">020</FONT>     * @author Qin ZHANG<a name="line.20"></a>
<FONT color="green">021</FONT>     */<a name="line.21"></a>
<FONT color="green">022</FONT>    public interface TelemetryReducer {<a name="line.22"></a>
<FONT color="green">023</FONT>    <a name="line.23"></a>
<FONT color="green">024</FONT>      /**<a name="line.24"></a>
<FONT color="green">025</FONT>       * Computes telemetry streams. Note that if there is no data for any particular time period, <a name="line.25"></a>
<FONT color="green">026</FONT>       * null should be used as the value for that time period.<a name="line.26"></a>
<FONT color="green">027</FONT>       * <a name="line.27"></a>
<FONT color="green">028</FONT>       * @param project The project which defines the scope of metrics to be used in the computation.<a name="line.28"></a>
<FONT color="green">029</FONT>       * @param dpdClient The DPD Client.<a name="line.29"></a>
<FONT color="green">030</FONT>       * @param interval The time interval.<a name="line.30"></a>
<FONT color="green">031</FONT>       * @param parameters Parameters passed to reducer implementation. In case a reducer does not<a name="line.31"></a>
<FONT color="green">032</FONT>       *        need any parameters, either null or an empty array may be passed.<a name="line.32"></a>
<FONT color="green">033</FONT>       * @throws TelemetryReducerException If there is any error during metrics computation.<a name="line.33"></a>
<FONT color="green">034</FONT>       * @return The resulting telemetry stream collection.<a name="line.34"></a>
<FONT color="green">035</FONT>       */<a name="line.35"></a>
<FONT color="green">036</FONT>      TelemetryStreamCollection compute(Project project, DailyProjectDataClient dpdClient, <a name="line.36"></a>
<FONT color="green">037</FONT>          Interval interval, String[] parameters) throws TelemetryReducerException;<a name="line.37"></a>
<FONT color="green">038</FONT>    }<a name="line.38"></a>




























































</PRE>
</BODY>
</HTML>
